home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 70.zip / BS1 part 70 / KickStart v2.07.20.adf / Instructions < prev    next >
Text File  |  1990-11-19  |  12KB  |  316 lines
  1.  
  2. Dear Amiga 2.0 Developer,
  3.  
  4.  
  5. Enclosed is Kickstart 2.02.  This release has completed all testing
  6. requirements, and been released for general consumption.  2.02 is a major
  7. maintenance release of Kickstart 2.00. Many bugs have been fixed, and a
  8. number of compatibility issues have been resolved.  No features have been
  9. added or removed.
  10.  
  11. The version number of the final Kickstart is 36.207.  As of this point 2.02
  12. is the new "base release", offered to all customers and developers.  Please
  13. upgrade; bug reports from earlier versions will soon be looked on with
  14. disfavor.
  15.  
  16. Use of 2.02 Kickstart requires a few minor changes and additions to your
  17. existing Workbench setup:
  18.  
  19.     1> The Topaz 11 font is no longer in ROM.  Your disk now needs to
  20.        contain a copy.  Don't forget to "fixfonts" after installing.
  21.  
  22.     2> The string "~#?.info" in the standard 2.0 startup-sequence
  23.        file must be changed to read "~(#?.info)".
  24.  
  25.     3> A 2.0 setpatch file has been provided (V36.4).
  26.  
  27. The above changes are automatically performed by the A3000 Update Disk
  28. (Available from dealers).  Non-A3000 users of 2.02 are expected to be
  29. technically adept.
  30.  
  31.  
  32.  
  33.  
  34.      Important Changes for Testers!
  35.  
  36.     - New ENFORCER, compatible with all MMU machines and all OS
  37.       releases (_including_ V1.3 emulation on an A3000).
  38.     - MUNGWALL, combination MemMung and MemWall debugging tool
  39.     - REPORT for generating new Bug, Compatibility, and Enhancement reports.
  40.     - ZKICK for softkicking with A2091+RAM, A590+RAM, and GVP peripherals
  41.     - Dev_Update/asl_lib.fd  - new correct fd file for asl.library.
  42.       Note that some of the Amiga.lib stubs for asl.library ...AslRequest
  43.       functions are incorrect.  Make #pragmas using the enclosed fd files.
  44.  
  45. ERRATA
  46. ======
  47.  
  48.     There was a bug in the 2.00 s:startup-sequence file.  The line:
  49.  
  50.     list >t:mon-start sys:monitors/~#?.info lformat="run >NIL: %s%s"
  51.  
  52.     Should read:
  53.  
  54.     list >t:mon-start sys:monitors/~(#?.info) lformat="run >NIL: %s%s"
  55.  
  56.     Dos library no longer accepts the invalid syntax of the second line.
  57.  
  58.  
  59.  
  60. Workbench V1.3.3
  61. ================
  62.  
  63. Since we were sending mail anyway, we decided to throw in V1.3.3 Workbench
  64. Beta 1. This is a minor upgrade to V1.3 Workbench.  Contains fixes for
  65. _Enforcer_ hits, and the old "switch between interlace/interlace/
  66. non-interlace" crashing bug.  Use "lharc" to decode the file.
  67.  
  68.  
  69.  
  70. ENFORCER
  71. ========
  72.  
  73.      New A3000-compatible Enforcer!  Enforcer is an indispensable debugging
  74. tool for all MMU machines.  This version of Enforcer can be used on the
  75. A3000, and on other Amigas with an MMU, provided the MMU is not otherwise
  76. in use.
  77.  
  78.      Enforcer is an MMU tool that traps illegal reads/writes to low-memory
  79. and non-existent memory spaces, and illegal writes to ROM space.  This
  80. catches an amazing number of programming errors, especially those with
  81. un-initialized and improperly initialized structures and pointers. When
  82. used in conjunction with memmung or mungwall (also provided) it will also
  83. catch trap many re-uses of freed memory (memmung or mungwall fill address 0
  84. and freed memory with values that tend to cause illegal memory accesses if
  85. they are referenced by your code.)
  86.  
  87.      Enforcer requires a serial terminal or printer (or parallel with
  88. enforcer.par - also provided).
  89.  
  90.      Note - If you have a modem attached, you can serial-debug on your own
  91. machine if you have a terminal program running at your modem's baud rate.
  92.  
  93.      For a remote terminal or Amiga, the following serial cable may be used:
  94.  
  95.     1 -- 1
  96.     2    2
  97.       \/
  98.       /\
  99.     3    3
  100.     7 -- 7
  101.     5,6,8    5,6,8
  102.       \/
  103.       /\
  104.        20    20
  105.  
  106.  
  107.      Hints:
  108.  
  109.     - Mixing kprintf/dprintf debugging with Enforcer/enforcer.par,
  110.       can help track down enforcer hits by providing intermixed
  111.       "About to do xxx" and enforcer hits on your terminal or printer.
  112.  
  113.     - While a program with enforcer hits is still running, it can
  114.       be helpful to use Wack or another disassembler to disassemble
  115.       the memory area around the PC address specified by enforcer.
  116.       (If the PC address is in ROM (or kickfile $200000 "rom") then
  117.       you probably passed a bad pointer or improperly initialized
  118.       structure to a system routine.  Trace forward on the stack
  119.       (SP) to find the return address to your own code.)
  120.  
  121.  
  122. MUNGWALL
  123. ========
  124.  
  125.     This software torture tool is a combination of MemMung and MemWall.
  126. The "Mung" part munges freed memory and address zero by filling them
  127. with values likely to cause illegal memory accesses if a null pointer
  128. or freed memory/pointer is used.  The "Wall" part allocates extra memory
  129. around your allocations and places special values in these buffer areas,
  130. and complains if these buffer areas get trashed.  MungWall's output
  131. is serial.  It should be used in combination with Enforcer if possible
  132. (Enforcer will generally catch the illegal accesses precipitated by
  133. MungWall so that you can find and debug them).
  134.  
  135.      The new version of MungWall includes a "WAIT" keyword which will let
  136. you throw the offending program into a Wait() for CTRL-C to allow you
  137. to debug it.  If the program you have Wait()'d has a unique Exec task name,
  138. you may then continue the program's execution using the provided program
  139. breaktask (breaktask taskname).
  140.  
  141. REPORT
  142. ======
  143.  
  144.     The new REPORT tool generates new format bug reports, compatibility
  145. reports, and enhancement requests.  The revised format provides more
  146. compact and consistent input for engineering's database.  See the file
  147. It is best to use REPORT directly to create your bug reports.  REPORT
  148. will prompt you for the required information and will format your
  149. answers properly for our database tools.  Most repeated information
  150. (name, configuration, etc.) will be prompted for only once and will
  151. be saved in your s: directory.    If you require new format blank report
  152. forms for use on other machines, use REPORT to generate them.
  153.  
  154.     See Kickfile/ReportForms for information on using Report or generating
  155. new report forms.
  156.  
  157.  
  158. KICKIT and ZKICK
  159. ================
  160.  
  161.      To use 2.0 Workbench on Amigas other than the A3000 you must first
  162. softkick the 2.0 operating system using Kickit or ZKick.
  163.  
  164.      Important:  As always, you should back up all important data from
  165. your hard drive and disks before testing any new version of the operating
  166. system.
  167.  
  168.      The Kickfile disk contains a kickstart image file called kick.[vers].20
  169. ([vers] is a version number).  Two different commands are provided in the
  170. Kickfile/Tools directory for softkicking this kickstart image file:
  171.  
  172.     KICKIT (by Bryce Nesbitt)
  173.     usage:    Kickit kickfilename    (ex. Kickit kick.190.20 )
  174.  
  175.     ZKICK (by developer Dan Zenchelsky)
  176.     usage:    ZKick kickfilename    (ex. ZKick kick.190.20 )
  177.  
  178.  
  179.      KICKIT should work on any machine whose first-configured expansion
  180. board is RAM >= 1meg.  If Kickfile:Tools/Config is run on these machines
  181. (prior to soft-kicking) it would show a RAM board at $200000 as the first
  182. listed board.  Such configurations include the following:
  183.  
  184.     - A500, A1000, A2000 with an initial Autoconfig RAM board
  185.     - A2500/20 or A2500/30
  186.     - Other configurations where first configured board is RAM at $200000
  187.  
  188.  
  189.      ZKICK by developer Dan Zenchelsky should allow you to soft-kick on
  190. some additional configurations:
  191.  
  192.     - A2000 with A2091+RAM as the first expansion board.
  193.     - A500 with A590+RAM
  194.     - A2000 with GVP peripherals that have the GVP "reset" PALS and
  195.         GVP "fastrom" driver
  196.  
  197.  
  198.      Note that on some configurations, ZKick may require CTRL-Amiga-Amiga
  199. to complete its initial reset of the machine after it loads the kickfile.
  200.  
  201.      KickIt has the benefit of extensive testing.  ZKick has the benefit
  202. of working on additional configurations.  Note that on a CTRL-Amiga-Amiga
  203. reboot, ZKick will reboot directly into the previously loaded 2.0 kickstart
  204. image.    If you use ZKick and a standard version-checking dual-startup,
  205. remember that you must turn off your Amiga after installing a new kickfile
  206. to cause your startup to ZKick the new kickfile.
  207.  
  208.  
  209.    Instructions for installing 2.0 follow.
  210.  
  211.  
  212.  
  213.                 Instructions
  214.                 ============
  215.  
  216. *****    This Release consists of the following software:
  217.       - Kickfile disk containing 512K 2.x Kick.[version].20 file
  218.  
  219.  
  220. *****    Where to find some important commands and files:
  221.  
  222.     - CPU           Workbench/c directory (cpu.doc in Kickfile/tools)
  223.     - Enforcer       Tools directory of Kickfile disk
  224.     - KickIt       Tools directory of Kickfile disk
  225.     - Kick.[vers].20   In the root of the Kickfile disk
  226.     - Report       Report generator in Kickfile/Tools
  227.     - ReportForms       Kickfile disk - tells how to use Report
  228.     - SampleStartup    Kickfile disk
  229.     - ZKick        Tools directory of Kickfile disk
  230.  
  231. *****    How to boot 2.0
  232.  
  233.     In order to use the new 2.0 Workbench, you must "soft-kick"
  234. the 2.0 operating system "kick.[version].20" using the new "Kickit"
  235. command (both found on the Kickfile disk).  Owners of GVP accelerator
  236. and harddisk+RAM cards (with GVP "reset" PALS and "fastrom" driver),
  237. A2091+RAM owners, and A590+RAM owners will instead use the ZKick command.
  238.  
  239.     NOTE - You should always back up your harddisk and work disks
  240.        before installing new operating system software.
  241.  
  242. ***** Easy Ways To Try 2.0
  243.  
  244. The simplest setup for trying 2.0 is ANY MODEL Amiga whose first or
  245. only autoconfig expansion card is RAM.
  246.  
  247. Some simple setups include an A2000 or A1000 with a 2-meg RAM expansion.
  248.  
  249. The KickIt and ZKick commands allow you to "soft-kick" a special 2.0
  250. operating system file so that you can use the 2.0 Workbench disk.
  251.  
  252. The simple no-installation way to boot 2.0 from floppies for testing follows:
  253. -----------------------------------------------------------------------------
  254.  
  255. 1. Boot normally with 1.3 and open a shell or CLI
  256.    Do a directory of the Kickfile disk to see the filename of the
  257.    kick.[vers].20 file ([vers] will probably be a 3-digit version number).
  258.  
  259. 2. With the Kickfile disk in df0:, type:
  260.        df0:Tools/kickit df0:kick.[vers].20
  261.        (kickit will read the kick.[vers].20 file and reboot your machine)
  262.  
  263. 3. When the 2.0 Workbench disk prompt appears, insert the 2.0 Workbench disk.
  264.  
  265.     NOTE - If you have an autoboot harddisk, pull the Kickfile disk
  266.       during the KickIt reboot, and insert the 2.0 Workbench disk to
  267.       boot the 2.0 Workbench.  If you use ZKick, there is no delay
  268.       between the kickfile load and the reset so you may need to
  269.       ZKick from an external drive with Workbench 2.0 already installed
  270.       in df0:.    See the SampleStartup file on the Kickfile
  271.       disk for instructions on installing 2.0 so that you can easily
  272.       boot into your choice of 1.3 or 2.0 from your harddisk.
  273. ---------------------------------------------------------------------------
  274.  
  275. You don't need an MMU, or coprocessor, or new ROMs, or ECS to use 2.0.
  276.  
  277. The following items are all OPTIONAL when using 2.0:
  278.  
  279. 68020, 68030, MMU, Enhanced Chip Set, multisync monitor, additional hardware
  280.  
  281. If you have a 2620 or 2630, the soft-kicked 2.0 will be in 32-bit RAM
  282. (fast!). If you have a harddrive, you can set your system up so that you
  283. can boot boot into 1.3 OR 2.0 off your harddrive (see SampleStartup on
  284. Kickfile disk). If you have the Enhanced Chip Set you will be able to try
  285. the new video modes (most require a multisync monitor).
  286.  
  287.  
  288.  
  289. ***** Special instructions for PAL machines and Multisync monitors
  290.  
  291.     Drag the appropriate Monitor icon from the Extras/MonitorStore to the
  292.     SYS:Monitors directory.
  293.  
  294.     The equivalent addmonitor commands follow:
  295.     addmonitor NUM=2 NAME=pal.monitor
  296.     addmonitor NUM=3 NAME=multisync.monitor
  297.     addmonitor NUM=4 NAME=A2024.monitor
  298.  
  299. BUG REPORTS
  300. ===========
  301.  
  302.         Bug reports may be submitted electronically via the USENET
  303.         computer network.  Mail address "bugs@commodore.COM" or
  304.         "uunet!cbmvax!bugs".  On BIX, report bugs in amiga.dev/bugs or
  305.         the special conferences (if you are a member).  Paper mail may
  306.         be sent to:
  307.  
  308.             Amiga Software Engineering Group
  309.             ATTN: Bug Reports
  310.             Commodore Business Machines
  311.             1200 Wilson Drive
  312.             West Chester, PA  19380-4231
  313.  
  314.         Always report the numbers as returned from the "config" or
  315.         "version" commands.
  316.